home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / apidev / tpapi.exe / DOCS / OLDDOCS.LZH / NWACCNTG.DOC < prev    next >
Text File  |  1993-10-13  |  5KB  |  108 lines
  1.                               ACCOUNTING SERVICES
  2.                               ===================
  3.  
  4. --------------------------------------------------------------------------------
  5.  
  6.  GetAccountStatus (BinderyObjectType : WORD;
  7.                    BinderyObjectName : ObjectNameType;
  8.                    VAR Balance, Limit : LONGINT;
  9.                    VAR Holds : Longint32ArrayType) : WORD;
  10.  
  11.  This function returns the account status of a bindery object.
  12.  
  13.  
  14.   BinderyObjectType (Input)         : bindery object type for which the
  15.                                       request is being made.
  16.  
  17.   BinderyObjectName (Input)         : name of the bindery object.
  18.  
  19.   Balance (Output)                  : number of value units left that the
  20.                                       object can use to buy network services.
  21.  
  22.   Limit (Output)                    : the level at which the object can reach
  23.                                       before it can no longer buy services.
  24.  
  25.   Holds (Output)                    : list of objects that have placed a hold
  26.                                       on the account.
  27.  
  28. --------------------------------------------------------------------------------
  29.  
  30.  SubmitAccountCharge (BinderyObjectType : WORD;
  31.                       BinderyObjectName : ObjectNameType;
  32.                       ServiceType : WORD; ChargeAmount,
  33.                       CancelHoldAmount : LONGINT;
  34.                       CommentType : WORD; Comment : String255Type) : WORD;
  35.  
  36.  This function updates the account of a bindery object.
  37.  
  38.  
  39.   BinderyObjectType (Input)         : bindery object type for which the
  40.                                       update is being made.
  41.  
  42.   BinderyObjectName (Input)         : name of the bindery object.
  43.  
  44.   ServiceType (Input)               : identifies the type of service for
  45.                                       which the update is being made.
  46.                                       (usually the object type of the
  47.                                       charging account server)
  48.  
  49.   ChargeAmount (Input)              : the amount the account server charges
  50.                                       for the service it provides.
  51.  
  52.   CancelHoldAmount (Input)          : the amount to be subtracted from the
  53.                                       total amount of all holds previously
  54.                                       placed by the server.  if no
  55.                                       SubmitAccountHolds call was made prior
  56.                                       then this should be 0.
  57.  
  58.   CommentType (Input)               : indicates the type of comment to be
  59.                                       placed in the audit report.
  60.  
  61.   Comment (Input)                   : comment to be placed in the audit
  62.                                       report.
  63.  
  64. --------------------------------------------------------------------------------
  65.  
  66.   SubmitAccountHold (BinderyObjectType : WORD;
  67.                      BinderyObjectName : ObjectNameType;
  68.                      ReserveAmount : LONGINT) : WORD;
  69.  
  70.     This function reserves a specified amount of an object's account balance
  71.     pending a SubmitAccountCharge call.
  72.  
  73.     BinderyObjectType (Input)         : bindery object type for which the
  74.                                         update is being made.
  75.  
  76.     BinderyObjectName (Input)         : name of the bindery object.
  77.  
  78.     ReserveAmount (Input)             : the hold amount to be placed against
  79.                                         the client's account pending service.
  80.  
  81. --------------------------------------------------------------------------------
  82.  
  83.   SubmitAccountNote (BinderyObjectType : WORD;
  84.                      BinderyObjectName : ObjectNameType;
  85.                      ServiceType, CommentType, CommentLen : WORD;
  86.                      Comment : String255Type) : WORD;
  87.  
  88.     This function adds a note about an object's account to an audit record.
  89.  
  90.     BinderyObjectType (Input)         : bindery object type for which the
  91.                                         update is being made.
  92.  
  93.     BinderyObjectName (Input)         : name of the bindery object.
  94.  
  95.     ServiceType (Input)               : identifies the type of service for
  96.                                         which the update is being made.
  97.                                         (usually the object type of the
  98.                                          charging account server)
  99.  
  100.     CommentType (Input)               : indicates the type of comment to be
  101.                                         placed in the audit report.
  102.  
  103.     CommentLen (Input)                : length of the comment.
  104.  
  105.     Comment (Input)                   : comment to be placed in the audit
  106.                                         report.
  107.  
  108. --------------------------------------------------------------------------------